Remove

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODFrame

Remove
The Remove method prepares this frame to be removed both from memory and persistent storage.
void Remove ();
DISCUSSION
Your part calls its embedded frame's Remove method when it permanently removes the frame from its content. This method in turn calls the DisplayFrameRemoved method of this frame's part to notify the part that this frame is being removed. During execution of the DisplayFrameRemoved method, this frame's part calls its embedded frames's Remove method recursively.
During execution of this method, this frame releases its references to the associated part and its containing frame, and this frame should not be used again. After this method executes successfully, you do not need to call your part's Release method.
Depending on whether you want to affect persistent storage, your part calls either this method or its frame's Close method.

EXCEPTIONS

kODErrFrameHasFacets
The specified frame has attached facets.

SEE ALSO
The ODFrame::Close method (page 314).
The ODPart::DisplayFrameRemoved method (page 498).
"Responding to a Removed Display Frame" on page 112 in OpenDoc Programmer's Guide.
"Removing an Embedded Frame" on page 121 in OpenDoc Programmer's Guide.
"Undo and Embedded Frames" on page 262 in OpenDoc Programmer's Guide.